Skip to content

Emphasize human-led productivity in docs - #989

Merged
bradygaster merged 4 commits into
github:devfrom
IEvangelist:dapine/986-responsible-ai-landing-page
Apr 17, 2026
Merged

bradygaster merged 4 commits into
github:devfrom
IEvangelist:dapine/986-responsible-ai-landing-page

Conversation

@IEvangelist

@IEvangelist IEvangelist commented Apr 16, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • reframe the homepage and README around human-led productivity and responsible AI
  • refine the landing page hero, callout, parallel-work copy, and visual emphasis
  • fix garbled search UI text and keep the docs build regression aligned
image

Validation

  • npx vitest run test\docs-build.test.ts

Notes

  • npm run build currently fails on the base branch with an unrelated TypeScript error in packages/squad-sdk/src/platform/comms-teams.ts (TOKEN_PATH vs tokenPath); this PR does not touch that area.

Closes #986

cc @diberry @bradygaster @tamirdresher

Reframe the docs landing page and README around human-led productivity, strengthen the responsible AI callouts and feature messaging, and fix the garbled docs search UI text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@IEvangelist
IEvangelist marked this pull request as ready for review April 16, 2026 17:40
Copilot AI review requested due to automatic review settings April 16, 2026 17:40

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Reframes the docs homepage and README to emphasize human-led productivity and responsible AI, while fixing garbled search UI strings and keeping the docs build regression test aligned with the new homepage copy.

Changes:

  • Update docs landing page hero/trust strip and add explicit “humans stay in charge” messaging.
  • Fix garbled Pagefind search UI text/keyboard shortcut labels.
  • Extend docs build test coverage to assert the new homepage messaging is present.

Reviewed changes

Copilot reviewed 4 out of 4 changed files in this pull request and generated 2 comments.

File Description
test/docs-build.test.ts Adds an assertion that the built landing page contains the new “Humans stay in charge” copy.
docs/src/pages/index.astro Rewrites homepage headline/sections to emphasize human-led productivity and responsible AI.
docs/src/components/Search.astro Replaces garbled characters in search UI strings and shortcut modifier label.
README.md Reframes product positioning and watch mode language toward human oversight and accountability.

Comment thread docs/src/pages/index.astro Resolved
Comment thread test/docs-build.test.ts Resolved
bradygaster and others added 3 commits April 16, 2026 11:25
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
Replace hero headline with "Your agents bring your ideas to life" and
subhead emphasizing that Squad helps you spend less time prompting,
more time deciding.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@bradygaster
bradygaster merged commit 5f9ccb9 into github:dev Apr 17, 2026
tamirdresher pushed a commit that referenced this pull request Apr 21, 2026
* Closes #986: emphasize human-led productivity in docs

Reframe the docs landing page and README around human-led productivity, strengthen the responsible AI callouts and feature messaging, and fix the garbled docs search UI text.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* Potential fix for pull request finding

Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>

* docs(landing): revise hero copy per feedback

Replace hero headline with "Your agents bring your ideas to life" and
subhead emphasizing that Squad helps you spend less time prompting,
more time deciding.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* docs(landing): reword Responsible AI callout

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Brady Gaster <41929050+bradygaster@users.noreply.github.com>
Co-authored-by: Copilot Autofix powered by AI <175728472+Copilot@users.noreply.github.com>
sabbour added a commit to sabbour/squad that referenced this pull request Apr 21, 2026
)

* fix(identity): cover all gh write commands and map reviewer roles to lead

- Template GIT IDENTITY block now uses session-level export GH_TOKEN pattern
  so every gh write command (review, comment, merge, edit, issue comment)
  uses the bot identity instead of falling through to the authenticated user.
- Added code review, reviewer, watchdog patterns to role-slug resolution
  so compound roles like 'Code Reviewer & Watchdog' route to lead tier.
- Compact template mention updated to reference expanded block.
- Fixes identity inconsistency seen on kickstart PRs github#986/github#989/github#990.

Closes github#986

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* test(identity): adversarial compound-role coverage

Add describe('compound and edge-case roles') block to role-slugs.test.ts
covering the class of bug where compound role strings (e.g.
"Code Reviewer & Watchdog") fell through to the 'backend' default.

Tests added:
- Production regression: "Code Reviewer & Watchdog" → lead
- "Lead, Architect" → lead
- "Security Architect" → lead (architect wins over security)
- "Code Reviewer" alone → lead
- "Reviewer" alone → lead
- "Watchdog" alone → lead
- "Senior Code Review Engineer" → lead
- "Backend & Reviewer" → lead (first-match: reviewer pos 4 beats backend pos 11)
- "Frontend Reviewer" → lead (first-match: reviewer pos 4 beats frontend pos 6)
- Case variants: CODE REVIEWER, code reviewer, Code Reviewer → all lead
- Whitespace: "  Code Reviewer  " → lead (substring match handles padding)
- Empty string → backend (DEFAULT_SLUG)
- "Quantum Bard" (unknown) → backend (DEFAULT_SLUG)

Two it.todo items flagged for Flight ruling:
- "Backend & Reviewer" ordering concern
- "Frontend Reviewer" ordering concern

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

* chore(fido): append compound-role adversarial session to history

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

---------

Co-authored-by: eecom[bot] <eecom[bot]@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
SabreSE pushed a commit to SabreSE/squad that referenced this pull request May 7, 2026
PR github#1023 merged insider into main, but insider was behind on docs changes
that had already landed on main via dev (PRs github#989, github#953, github#955, github#956, github#906).
The merge resolution picked insider's older versions, reverting 25 docs files.

This restores all affected files from dev:
- David Pine's human-led productivity emphasis (PR github#989)
- Cross-links between related documentation (PR github#956)
- Compaction recovery, coordinator restraint, result persistence refs
- Teams async adapter migration guide
- State backends feature doc
- Search/Sidebar component updates
- Landing page content

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs lean more on productivity and enablement

3 participants